package com.ruoyi.system.service;

import java.util.List;

import com.ruoyi.common.core.domain.entity.SysDictData;

/**
 * 字典 业务层
 *
 * @author ruoyi
 */
public interface ISysDictDataService {
    /**
     * 根据条件分页查询字典数据
     *
     * @param dictData 字典数据信息，包含查询条件
     * @return 字典数据集合信息，符合查询条件的字典数据列表
     */
    public List<SysDictData> selectDictDataList(SysDictData dictData);

    /**
     * 根据字典类型和字典键值查询字典数据信息
     *
     * @param dictType  字典类型，用于指定字典分类
     * @param dictValue 字典键值，用于指定具体的字典项
     * @return 字典标签，对应字典项的显示名称
     */
    public String selectDictLabel(String dictType, String dictValue);

    /**
     * 根据字典数据ID查询信息
     *
     * @param dictCode 字典数据ID，唯一标识一个字典数据项
     * @return 字典数据，包含该ID对应的完整字典数据信息
     */
    public SysDictData selectDictDataById(Long dictCode);

    /**
     * 批量删除字典数据信息
     *
     * @param dictCodes 需要删除的字典数据ID数组，包含多个待删除的字典项ID
     */
    public void deleteDictDataByIds(Long[] dictCodes);

    /**
     * 新增保存字典数据信息
     *
     * @param dictData 字典数据信息，包含待新增的字典项完整信息
     * @return 结果，返回影响的记录数，通常1表示成功，0表示失败
     */
    public int insertDictData(SysDictData dictData);

    /**
     * 修改保存字典数据信息
     *
     * @param dictData 字典数据信息，包含待修改的字典项完整信息
     * @return 结果，返回影响的记录数，通常1表示成功，0表示失败
     */
    public int updateDictData(SysDictData dictData);
}

